Scripting
开始
文档
更新日志
隐私
开始
文档
更新日志
隐私
简体中文

首选配色模式

tint 属性用于为视图设置局部的强调色，覆盖默认的系统 accent color。与应用的全局 accent color 不同，tint 不会被用户偏好覆盖，始终有效，适合用来强调控件的语义意义或视觉重点。

定义

1tint?: ShapeStyle | DynamicShapeStyle

支持的值

  • ShapeStyle：可为纯色、渐变或系统材质。
  • DynamicShapeStyle：可根据浅色/深色模式自动切换的样式。

常见用途

  • 设置如 Toggle、Slider、Button、ProgressView 等控件的本地着色。
  • 在表单、列表或弹窗中标记具有特定意义的组件。
  • 保证 UI 色彩在不同用户主题下始终一致。

示例：基础颜色着色

1<Toggle
2  tint="systemGreen"
3  // ...
4/>

示例：渐变着色

1<ProgressView
2  value={0.6}
3  tint={{
4    gradient: [
5      { color: "red", location: 0 },
6      { color: "orange", location: 1 }
7    ],
8    startPoint: { x: 0, y: 0 },
9    endPoint: { x: 1, y: 1 }
10  }}
11/>

示例：深浅模式适配

1<Slider
2  tint={{
3    light: "blue",
4    dark: "purple"
5  }}
6  // ...
7/>
大纲